Глава 13. Массивы, структуры и списки CFML

Массивы
Структуры
Списки
- Поиск, сортировка, проверка и просмотр списков
- Изменение и преобразование списков
Резюме

Глава 13

Массивы, структуры и списки CFML

Как было сказано в главе 9, ColdFusion доступно достаточно большое количество типов переменных. В той же главе мы постарались описать каждый из существующих типов, к которым относятся и такие типы, как массивы (arrays), структуры (structures) и списки (lists). На наш взгляд эти типы заслуживают отдельного внимания. При большом количестве отдельных переменных более эффективно использовать вместо них массивы, структуры или списки.

Массивы

Массивы (arrays) — это группа переменных одного типа, доступ к которым осуществляется с помощью общего имени. Хотя функция ArrayNew только поддерживает создание массивов до трехмерной размерности, массив не имеет предела на размер или максимальное значение.

Надо отметить, что массивы ColdFusion несколько отличаются от традиционных массивов, т. к. они являются динамическими, и если для обычных массивов их размер постоянен и симметричен, то массивы ColdFusion могут иметь ряды, отличающиеся друг от друга в зависимости от добавленных или удаленных данных.

Создание массива

Для использования массива необходимо предварительно его объявить:

где х — число, отражающее размерность массива, которое может принимать значение от 1 до 3.

К примеру, создадим одномерный массив и запишем в уже существующий массив два элемента следующим образом:

В следующем примере создадим двумерный массив и заполним его:

Как уже было замечено, максимальное значение размерности массива в ColdFusion определяется значением 3 (трехмерный). Однако всегда можно создать массив массивов, т. е. когда массиву назначается вложенный элемент, являющийся также массивом. При этом за счет вложенного массива увеличивается и размерность внешнего массива. Например:

<CFSET TicketArray[3][2] [1] = TravelerArrayX

Проверка массива

Функция ArrayisEmpty (array) проверяет, является ли массив пустым. П Функция ArrayLen (array) возвращает длину заданного массива.
Функция isArray(value [, number]) возвращает True, если значение является массивом. Здесь number — число, позволяющее уточнить проверку соответствия количества элементов массива.

Добавление элементов

Функция ArrayAppend(array, value) добавляет элемент в конец заданного массива.
Функция Arrayprepend(array, value) добавляет элемент в начало заданного массива.
Функция ArraylnsertAt (array, position, value) вставляет элемент массива на указанную позицию.
Функция ArraySet(array, start_pos, end_pos, value) присваивает определенное значение ряду элементов одномерного массива в указанном диапазоне.

Например:

<HTML>

<HEAD>

<TITLE>myArray</TITLE>

</HEAD>

<BODY>

<CFSET CruiseArray[1] =

"World Financial Center">

<CFSET CruiseArray[2] =

"Ellis Island">

<CFSET ArrayPrepend{CruiseArray,

"World Trade Center")>

<CFSET ArrayAppendtCruiseArray,

"Statue of Liberty")>

<CFSET ArraylnsertAt(CruiseArray,

3, "Battery Park")>

<CFSET ArraySet(CruiseArray, 6,

8, "Repair")>

<CFIF IsArray(CruiseArray)

AND ArraylsEmpty(CruiseArray) eq false>

<CFLOOP INDEX = "i" FROM = "1"

TO = #ArrayLen(CruiseArray)#>

<CFOUTPUT>#i#. #CruiseArray[i]#</CFOUTPUT>

</CFLOOP> </CFIF> </BODY> </HTML>

В результате приведенного выше примера создается одномерный массив CruiseArray с восемью элементами. При этом значения элементов массива выводятся на экран в следующем виде:

World Trade Center
World Financial Center
Battery Park
Ellis Island
Statue of Liberty 6. Repair
Repair 8. Repair

Также заполнение массива можно осуществлять непосредственно значениями из базы данных, используя для этой цели тег условного цикла <CFLOOP> с атрибутом QUERY, как показано ниже:

<TITLE>myArray2d</TITLE>

</HEAD> <BODY>

SELECT Key_tou, Name_tou FROM Tour ORDER BY Key_tou </CFQUERY>

<CFSET TourArray2d[CurrentRow][1] =

Key_tou[CurrentRow]>

<CFSET TourArray2d[CurrentRow][2] =

Name_tou[CurrentRow]> </CFLOOP>

<CFIF IsArray(TourArray2d) AND

ArraylsEmpty(TourArray2d) eq false>

<CFLOOP INDEX = "i" FROM = "1" TO =

lArrayLen(TourArray2d)#>

<CFOUTPUT>#TourArray2d[i][1]#

#TourArray2d[i][2]#</CFOUTPUT>

</CFLOOP> </CFIF> </BODY> </HTML>

В результате выполнения приведенного примера создается двумерный массив TourArray2d с присвоением его элементам значений в зависимости от содержимого базы данных и последующим выводом их на экран.

Регулирование положением элементов массива

Функция ArraySort(array, sort_type [, sort_order]) сортирует элементы массива.

Для функции ArraySort можно задавать следующие типы сортировки (sort_type):

Numeric — сортировка числовых величин;
Text — сортировка в алфавитном порядке, сначала выводятся значения с учетом верхнего регистра, затем нижнего;
TextNoCase — сортировка в алфавитном порядке без учета чувствительности к регистру.

Также функция ArraySort поддерживает сортировку (sort_order):

ASс — по возрастанию (по умолчанию);
Desc — по убыванию.

Например, для сортировки уже существующего массива CruiseArray в алфавитном порядке по возрастанию достаточно включить следующую строку кода:

В результате элементы для нашего примера будут отсортированы следующим образом:

Battery Park
Ellis Island
Repair
Repair
Repair
Statue of Liberty
World Financial Center
World Trade Center

Фунуция ArraySwap (array, position1, position2) переставляет элементы массива.

Например, чтобы переставить местами первый и шестой элементы в уже отсортированном массиве CruiseArray, достаточно включить следующую строку кода:

В результате список элементов массива CruiseArray приобретет следующий вид:

Statue of Liberty
Ellis Island
Repair
Repair
Repair
Battery Park
World Financial Center
World Trade Center

Удаление элементов

Функция Arrayciear (array) удаляет все данные из массива.

Например, для очистки уже существующего массива CruiseArray достаточно включить следующую строку кода:

Функция ArrayDeleteAt (array, position) удаляет элемент массива, находящийся на указанной позиции.

Если есть необходимость удалить третий по счету элемент массива CruiseArray, следует включить строку кода, показанную ниже:

Обработка значений элементов

Функция ArrayAvg (array) возвращает среднее значение по всем элементам массива.
Функция ArrayMax (array) возвращает максимальное значение элементов массива.
Функция ArrayMin (array) возвращает минимальное значение элементов массива.
Функция ArraySum (array) возвращает сумму значений элементов массива. Например:

<TITLE>myArray</TITLE>

</HEAD> <BODY>

SELECT CostAdult_tou

FROM Tour </CFQUERY>

<CFOUTPUT>#CostArray[i]#</CFOUTPUT>

</CFLOOP> </CFIF>

<CFOUTPUT>CostAvg: ttArrayAvg(CostArray)#</CFOUTPUT>

<CFOUTPUT>CostMax: #ArrayMax(CostArray)#</CFOUTPUT>

<CFOUTPUT>CostMin: #ArrayMin(CostArray)#</CFOUTPUT>

<CFOUTPUT>CostSum: #ArraySum(CostArray)#</CFOUTPUT>

</BODY> </HTML>

Результат работы приведенного выше кода таков:

13.00 20.00 24.00 20.00

CostAvg: 19.25

CostMax: 24

CostMin: 13

CostSum: 77

Преобразование массивов

Функция AfrayToList (array [, delimiter]} возвращает список элементов, преобразуя данные из массива. Здесь delimiter воспринимается как разделитель. По умолчанию разделителем является запятая (,).

Например, для создания списка, получаемого преобразованием данных уже существующего массива CostArray, достаточно включить следующий код:

<CFOUTPUT>#CostList#</CFOUTPUT>

Результатом будет строка, отображающая содержание нового списка:

13.00,20.00,24.00,20.00 Или, к примеру:

<CFOUTPUT>#CostList2#</CFOUTPUT>

Здесь же результат несколько изменится и будет таким:

13 . 00—20. 00—24 . 00—20. 00

Размер массива

Функция ArrayResize (array, minimum_size) задает размер массива.

Например:

Таким образом, мы определяем минимальный размер массива, равный 30 элементам.

Структуры

Вы можете использовать структуры (structures), чтобы создавать и поддерживать пары ключевых значений, обращаться к связанным символьным значениям как к общности, а не как к индивидуальным значениям, или создавать ассоциативные массивы.

Создание структуры

Для использования структуры необходимо предварительно ее объявить:

К примеру, создадим структуру и присвоим значения двум ее элементам:

При этом был использован синтаксис ассоциативных массивов. Однако подобного результата можно добиться, применяя объектно-ориентированный синтаксис доступа к элементам, например:

Впрочем, в случае объектно-ориентированного синтаксиса необходимо, чтобы ключ, указанный после точки, начинался с буквы, и в названии ключа были использованы буквы, цифры и символы подчеркивания без разделительных пробелов. Приведем пример воспринимаемых и невоспринимаемых наименований ключей при использовании объектно-ориентированного синтаксиса.

Воспринимаемые наименования:

RS1_ 98 О R1_S_98 П R12345

Невоспринимаемые наименования:

_RS1_98 П RS1-98 П RS1:'98 П 9RS1_98

Также присвоение значений элементов структуры можно осуществлять с помощью функций.

Проверка структуры

Функция StructIsEmpty (structure) проверяет, является ли структура пустой.
Функция StructCount (structure) возвращает количество ключей в заданной структуре.
Функция structKeyExists (structure, key) проверяет наличие ключа в массиве.
Функция IsStruct (variable) возвращает True, если значение является структурой.

Добавление элементов и модификация структуры

Функция StructInsert (structure, key, value [, allowoverwrite] ) вставляет пару "ключ/значение" в заданную структуру. Здесь allowoverwrite указывает на возможность переписывать ключи (по умолчанию Falee).
Функция StructUpdate (structure, key, value) производит обновление данных в структуре.
Функция StructAppend(structl, struct2, overwriteFlag) добавляет В конец одной структуры другую структуру. Здесь structl — структура, в конец которой происходит добавление данных из структуры struct2. Если overwriteFlag равно Yes (ПО умолчанию), то значения структуры struct2 переписывают соответствующие значения в структуре structl. Например:

<TITLE>myStruct</TITLE>

</HEAD> <BODY>

<CFIF IsStruct(TravelerStruct) AND StructIsEmpty(TravelerStruct)

eq false> <CFLOOP COLLECTION = #TravelerStruct# ITEM = "i">

<CFOUTPUT>#i# - #TravelerStruct[i]#</CFOUTPUTXbr> </CFLOOP> </CFIF> </BODY> </HTML>

В результате выполнения приведенного выше примера создается структура TravelerStruct с девятью значениями в соответствии с ключами. При этом значения структуры выводятся на экран в порядке добавления:

RS1_98 — Nomar Garciaparra RS2_98 - Pedro

Martinez RS3_98 - Tom Gordon RS4_98 - Mike

Stanley RS5_98 — Reggie Jefferson RS6_98 - Mark

Portugal RS7_98 - John Valentin RS8_98 - Jose

Offerman RS9_98 - Trot Nixon

Удаление элементов структуры

Функция structciear (structure) удаляет все данные из структуры.

Например, для очистки уже существующей структуры TravelerStruct достаточно включить следующую строку кода:

Функция StructDelete (structure, key [, indicatenotexisting]) удаляет элемент структуры с указанным значением ключа. Здесь indicatenotexisting указывает на необходимость возвращения отрицательного значения при попытке удаления элемента с несуществующим ключом. По умолчанию NO.

Если есть необходимость удалить элемент структуры Travelerstruct со значением ключа RS7_98 и при этом убедиться, что попытка удаления оказалась удачной, необходимо включить код, показанный ниже:

Item Delete </CFIF>

Или так:

</CFIF>

Преобразование структур

Функция structKeyArray (structure) возвращает массив ключей, преобразуя данные из структуры.
Функция StructKeyList (structure, [delimiter]) возвращает cписок ключей, преобразуя данные из структуры.

Например, для создания списка ключей, получаемого преобразованием данных уже существующей структуры TravelerStruct, достаточно включить следующий код:

<CFOOTPUT>#TravelerListtt</CFOUTPUT>

Результатом чего будет строка, отображающая содержание нового списка:

RS1_98,RS2_98,RS3_98,RS4_98,RS5_98,

RS6_98,RS7_98,RS8_98,RS9_98

Другие функции обработки структур

Функция structcopytstructure) копирует структуру.

Например, следующая строка позволяет скопировать структуру TravelerStruct во вновь Созданную структуру TravCopyStruct: <CFSET TravCopyStruct = StructCopy(TravelerStruct)>

Функция structFind(structure, key) выполняет поиск данных по ключу в указанной структуре.

Например, для осуществления поиска значений по ключу RS4_98 в структуре TravelerStruct необходимо включить следующую пару строк кода:

<CFOUTPUT>|ResultFind#</CFOUTPUT>

Результатом для нашего примера будет вывод найденного значения:

Mike Stanley

Списки

Списки (lists) — специальный символьный тип, составленный из элементов, отделенных разделителями.

Вы можете самостоятельно определять разделитель для списка. Причем разделитель может состоять из нескольких символов. По умолчанию в качестве разделителя принимается запятая (,).

Разделители перед первым элементом и после последнего элемента игнорируются.

Структура списков — плоская, т. е. списки не могут быть вложены друг в друга. Также, списки не могут содержать никакие "пустые" элементы. Однако список может быть пуст. При этом он эквивалентен пустому значению "".

В следующих разделах при описании функций обработки списков параметр delimiter необходимо воспринимать как разделитель.

Поиск, сортировка, проверка и просмотр списков

Функция ListFinddist, value [, delimiters]) осуществляет поиск значений в списке с заданным разделителем.
Функция ListFindNoCase (list, value [, delimiters]) выполняет поиск значений в списке без учета регистра.
Функция ListContains (list, substring [, delimiters]) возвращает позицию в списке, начиная с которой встречается заданный фрагмент текста (подстрока).
Функция ListContainsNoCase (list, substring [, delimiters]) возвращает позицию в списке, начиная с которой встречается заданный фрагмент текста, без учета регистра.
Функция ListSort (list, sort_type [, sort_order] [, delimiter]) сортирует элементы списка с учетом разделителя.

Для функции ListSort так же, как и для функции ArraySort, можно задавать следующие типы сортировки (sort_type):

Numeric — сортировка числовых величин;
Text — сортировка в алфавитном порядке, сначала выводятся значе-' ния с учетом верхнего регистра, затем нижнего;
TextNoCase — сортировка в алфавитном порядке без учета чувствительности к регистру.

Также функции Listsort поддерживает сортировку (sort_order):

АsС — по возрастанию (по умолчанию);
Desc — по убыванию.
Функция ListLen (list [, delimiters]) Возвращает длину списка.
Функция ListFirst (list [, delimiters]) возвращает первый элемент списка.
Функция ListLast(list [, delimiters]) возвращает последний элемент списка.
Функция ListRest (list [, delimiters]) возвращает список без первого значения.
Функция ListGetAt (list, position [, delimiters]) Возвращает элемент из заданной позиции в списке.
Функция ListValueCount (list, value [, delimiters]) возвращает количество вхождений заданного значения в списке.
Функция ListValueCountNoCase (list, value [, delimiters]) возвращает количество вхождений заданного значения в списке без учета регистра. Например:

<TITLE>myList</TITLE> </HEAD> <BODY>

<CFOUTPUT>List: #MyListl</CFOUTPUTXbr>

<CFOUTPUT>Count of elements: #ListLen (MyList)

#</CFOUTPUT>

<CFOUTPUT>The first element: #ListFirst(MyList)

#</CFOUTPUT>

<CFOUTPUT>The last element: #ListLast(MyList)

#</CFOUTPUT>

<CFOUTPUT>The third element: #ListGetAt (MyList,

3) #</CFOUTPUT>

<CFOUTPUT>The element — "Orange" has number of a position:

#ListFind(MyList, "Orange") #</CFOUTPUT>

</BODY> </HTML>

В результате приведенного выше примера на экран будет выведено следующее:

List: Black,Magenta,Cyan,Orange,

Darkgray,Pink,Gray,White,Lightgray,

Yellow Count of elements: 10 The

first element: Black

The last element: Yellow

The third element: Cyan

The element — "Orange" has number of a position: 4

Изменение и преобразование списков

Функция ListAppend(list, value [, delimiters]) добавляет значение в конец списка.
Функция ListPrepend (list, value [, delimiters]) добавляет значение в начало списка.
Функция ListlnsertAt(list, position, value [, delimiters]) добавляет значение в заданную позицию списка.
Функция ListSetAt(list, position, value [, delimiters]) изменяет значение в заданной позиции списка.
Функция ListDeleteAt(list, position [, delimiters]) удаляет значение из заданной позиции.
Функция ListChangeDelims(list, new_delimiter [, delimiters]) заменяет в списке все разделители.
Функция ListQualify(list, qualifier [, delimiters] [, elements]) выделяет элементы списка с помощью указанного символа или набора символов. Здесь в качестве параметра elements может быть включен символ или набор символов, которые необходимо выделить.
Функция ListToArray(list [, delimiter]) возвращает массив, преоб-разуя данные из списка с учетом указанного разделителя.
Функция ValueList( query, column [, delimiter]) возвращает список значений колонки предварительно выполненного запроса.
Функция QuotedValueList (query, column [, delimiter]) возвращает список значелий колонки предварительно выполненного запроса, с выделением элементов списка с помощью кавычек.

Например:

<TITLE>myList</TITLE> </HEAD> <BODY>

<CFSET MyList =

"Black,Magenta,Cyan,Orange,Darkgray,

Pink,Gray,White,Lightgray,Yellow">

<CFOUTPUT>List: #MyList#</CFOUTPUTXbr>

<CFSET myColorArray = ListToArray

(fListAppend(MyList, "NewColor")#)>

<CFLOOP INDEX = "i" FROM = "1" TO =

#ArrayLen(myColorArray)#>

<CFOUTPUT>#i#. #myColorArray[i]

#</CFOUTPUT> </CFLOOP>

</BODY> </HTML>

В результате приведенного выше примера на экран будет выведено следующее:

List: Black,Magenta,Cyan,Orange,Darkgray,

Pink,Gray,White,Lightgray,Yellow

1. Black

2. Magenta

3. Cyan

4. Orange

5. Darkgray

6. Pink

7. Gray

8. White

9. Lightgray

10. Yellow

11. NewColor

В предыдущих примерах, демонстрирующих обработку списков, мы определяли строковую переменную myList вручную. Впрочем, список также можно сформировать из предварительно выполненного запроса. К примеру, получим список круизов из уже знакомой нам базы данных cruise и отсортируем полученные значения по алфавиту, используя функцию ListSort:

<TITLE>myList</TITLE> </HEAD> <BODY>

<CFQUERY NAME="GetTour" DATASOURCE="#application.dsn#"> SELECT *

FROM Tour </CFQUERY>

<CFSET myListTour = ValueList(GetTour.Name_tou)> <CFOUTPUT>#ListSort(myListTour, "Text", "Asc")#

</CFOUTPUT> </BODY> </HTML>

В результате работы приведенного примера на экран будет выведен список маршрутов через запятую, как показано ниже:

1-hr Seaport Liberty,2-hr Harbor Lights Evening,2-hr Semi Circle,The Full Island

Резюме

В данной главе вы познакомились с возможностями обработки массивов, структур и списков. Эти типы данных облегчают понимание ColdFusion и в дальнейшем позволят вам с легкостью разрабатывать собственные Web-приложения.